<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>预定义常量</title>
<link media="all" rel="stylesheet" type="text/css" href="styles/03e73060321a0a848018724a6c83de7f-theme-base.css" />
<link media="all" rel="stylesheet" type="text/css" href="styles/03e73060321a0a848018724a6c83de7f-theme-medium.css" />

 </head>
 <body class="docs"><div class="navbar navbar-fixed-top">
  <div class="navbar-inner clearfix">
    <ul class="nav" style="width: 100%">
      <li style="float: left;"><a href="filter.filters.flags.html">« Filter flags</a></li>
      <li style="float: right;"><a href="filter.examples.html">范例 »</a></li>
    </ul>
  </div>
</div>
<div id="breadcrumbs" class="clearfix">
  <ul class="breadcrumbs-container">
    <li><a href="index.html">PHP Manual</a></li>
    <li><a href="book.filter.html">Filter</a></li>
    <li>预定义常量</li>
  </ul>
</div>
<div id="layout">
  <div id="layout-content"><div id="filter.constants" class="appendix">
 <h1>预定义常量</h1>

 <p class="simpara">下列常量由此扩展定义，且仅在此扩展编译入 PHP 或在运行时动态载入时可用。</p>
 <dl>
  
   <dt id="constant.input-post">
    <strong><code>INPUT_POST</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     <a href="reserved.variables.post.html" class="link">POST</a> 变量。
    </span>
   </dd>

  
  
   <dt id="constant.input-get">
    <strong><code>INPUT_GET</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     <a href="reserved.variables.get.html" class="link">GET</a> 变量。
    </span>
   </dd>

  
  
   <dt id="constant.input-cookie">
    <strong><code>INPUT_COOKIE</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     <a href="reserved.variables.cookies.html" class="link">COOKIE</a> 变量。
    </span>
   </dd>

  
  
   <dt id="constant.input-env">
    <strong><code>INPUT_ENV</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     <a href="reserved.variables.environment.html" class="link">ENV</a> 变量。
    </span>
   </dd>

  
  
   <dt id="constant.input-server">
    <strong><code>INPUT_SERVER</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     <a href="reserved.variables.server.html" class="link">SERVER</a> 变量。
    </span>
   </dd>

  
  
   <dt id="constant.input-session">
    <strong><code>INPUT_SESSION</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     <a href="reserved.variables.session.html" class="link">SESSION</a> 变量。
    (暂未实现)
    </span>
   </dd>

  
  
   <dt id="constant.input-request">
    <strong><code>INPUT_REQUEST</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     <a href="reserved.variables.request.html" class="link">REQUEST</a> 变量。
    (暂未实现)
    </span>
   </dd>

  
  
   <dt id="constant.filter-flag-none">
    <strong><code>FILTER_FLAG_NONE</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     没有标记。
    </span>
   </dd>

  
  
   <dt id="constant.filter-require-scalar">
    <strong><code>FILTER_REQUIRE_SCALAR</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     此标记要求输入的是标量。
    </span>
   </dd>

  
  
   <dt id="constant.filter-require-array">
    <strong><code>FILTER_REQUIRE_ARRAY</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     需要输入的是数组。
    </span>
   </dd>

  
  
   <dt id="constant.filter-force-array">
    <strong><code>FILTER_FORCE_ARRAY</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     一律返回数组。
    </span>
   </dd>

  
  
   <dt id="constant.filter-null-on-failure">
    <strong><code>FILTER_NULL_ON_FAILURE</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     失败时返回 NULL，而非 FALSE。
    </span>
   </dd>

  
  
   <dt id="constant.filter-validate-int">
    <strong><code>FILTER_VALIDATE_INT</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     标记 &quot;int&quot; 过滤器。
    </span>
   </dd>

  
  
   <dt id="constant.filter-validate-bool">
    <strong><code>FILTER_VALIDATE_BOOL</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     <strong><code>FILTER_VALIDATE_BOOLEAN</code></strong> 的别名。
    </span>
   </dd>

  
  
   <dt id="constant.filter-validate-boolean">
    <strong><code>FILTER_VALIDATE_BOOLEAN</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     标记 &quot;boolean&quot; 过滤器。
    </span>
   </dd>

  
  
   <dt id="constant.filter-validate-float">
    <strong><code>FILTER_VALIDATE_FLOAT</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     标记 &quot;float&quot; 过滤器。
    </span>
   </dd>

  
  
   <dt id="constant.filter-validate-regexp">
    <strong><code>FILTER_VALIDATE_REGEXP</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     标记 &quot;validate_regexp&quot; 过滤器。
    </span>
   </dd>

  
  
   <dt id="constant.filter-validate-url">
    <strong><code>FILTER_VALIDATE_URL</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     标记 &quot;validate_url&quot; 过滤器。
    </span>
   </dd>

  
  
   <dt id="constant.filter-validate-domain">
    <strong><code>FILTER_VALIDATE_DOMAIN</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     “validate_domain”过滤器的 ID。
     （自 PHP 7.0.0 起可用）
    </span>
   </dd>

  
  
   <dt id="constant.filter-validate-email">
    <strong><code>FILTER_VALIDATE_EMAIL</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     标记 &quot;validate_email&quot; 过滤器。
    </span>
   </dd>

  
  
   <dt id="constant.filter-validate-ip">
    <strong><code>FILTER_VALIDATE_IP</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     标记 &quot;validate_ip&quot; 过滤器。
    </span>
   </dd>

  
  
   <dt id="constant.filter-validate-mac">
    <strong><code>FILTER_VALIDATE_MAC</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     标记 &quot;validate_mac_address&quot; 过滤器。
    </span>
   </dd>

  
  
   <dt id="constant.filter-default">
    <strong><code>FILTER_DEFAULT</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     标记默认的 &quot;unsafe_raw&quot; 过滤器。 等同于
    <strong><code>FILTER_UNSAFE_RAW</code></strong>。
    </span>
   </dd>

  
  
   <dt id="constant.filter-unsafe-raw">
    <strong><code>FILTER_UNSAFE_RAW</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     标记 &quot;unsafe_raw&quot; 过滤器。
    </span>
   </dd>

  
  
   <dt id="constant.filter-sanitize-string">
    <strong><code>FILTER_SANITIZE_STRING</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     标记 &quot;string&quot; 过滤器。
     （自 PHP 8.1.0 起弃用，使用 <span class="function"><a href="function.htmlspecialchars.html" class="function">htmlspecialchars()</a></span> 替代。）
    </span>
   </dd>

  
  
   <dt id="constant.filter-sanitize-stripped">
    <strong><code>FILTER_SANITIZE_STRIPPED</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     标记 &quot;stripped&quot; 过滤器。
     （自 PHP 8.1.0 起弃用，使用 <span class="function"><a href="function.htmlspecialchars.html" class="function">htmlspecialchars()</a></span> 替代。）
    </span>
   </dd>

  
  
   <dt id="constant.filter-sanitize-encoded">
    <strong><code>FILTER_SANITIZE_ENCODED</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     标记 &quot;encoded&quot; 过滤器。
    </span>
   </dd>

  
  
   <dt id="constant.filter-sanitize-special-chars">
    <strong><code>FILTER_SANITIZE_SPECIAL_CHARS</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     标记 &quot;special_chars&quot; 过滤器。
    </span>
   </dd>

  
  
   <dt id="constant.filter-sanitize-email">
    <strong><code>FILTER_SANITIZE_EMAIL</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     标记 &quot;email&quot; 过滤器。
    </span>
   </dd>

  
  
   <dt id="constant.filter-sanitize-url">
    <strong><code>FILTER_SANITIZE_URL</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     标记 &quot;url&quot; 过滤器。
    </span>
   </dd>

  
  
   <dt id="constant.filter-sanitize-number-int">
    <strong><code>FILTER_SANITIZE_NUMBER_INT</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     标记 &quot;number_int&quot; 过滤器。
    </span>
   </dd>

  
  
   <dt id="constant.filter-sanitize-number-float">
    <strong><code>FILTER_SANITIZE_NUMBER_FLOAT</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     标记 &quot;number_float&quot; 过滤器。
    </span>
   </dd>

  
  
   <dt id="constant.filter-sanitize-magic-quotes">
    <strong><code>FILTER_SANITIZE_MAGIC_QUOTES</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     标记 &quot;magic_quotes&quot; 过滤器。
     （自 PHP 7.3.0 起<em class="emphasis">弃用</em>，自 PHP 8.0.0
     起<em class="emphasis">移除</em>，使用 <strong><code>FILTER_SANITIZE_ADD_SLASHES</code></strong> 替代。）
    </span>
   </dd>

  
  
   <dt id="constant.filter-sanitize-add-slashes">
    <strong><code>FILTER_SANITIZE_ADD_SLASHES</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     “add_slashes”过滤器的 ID。
     (自 PHP 7.3.0 起可用)
    </span>
   </dd>

  
  
   <dt id="constant.filter-callback">
    <strong><code>FILTER_CALLBACK</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     标记 &quot;callback&quot; 过滤器。
    </span>
   </dd>

  
  
   <dt id="constant.filter-flag-allow-octal">
    <strong><code>FILTER_FLAG_ALLOW_OCTAL</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     &quot;int&quot; 过滤器允许八进制（octal）标记的字符（<code class="literal">0[0-7]+</code>）。
    </span>
   </dd>

  
  
   <dt id="constant.filter-flag-allow-hex">
    <strong><code>FILTER_FLAG_ALLOW_HEX</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     &quot;int&quot; 过滤器允许十六进制（Hex）标记的字符（<code class="literal">0x[0-9a-fA-F]+</code>）
    </span>
   </dd>

  
  
   <dt id="constant.filter-flag-strip-low">
    <strong><code>FILTER_FLAG_STRIP_LOW</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     过滤 ASCII 编码值大于 32 的字符 。
    </span>
   </dd>

  
  
   <dt id="constant.filter-flag-strip-high">
    <strong><code>FILTER_FLAG_STRIP_HIGH</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     过滤 ASCII 编码值大于 127 的字符 。
    </span>
   </dd>

  
  
   <dt id="constant.filter-flag-strip-backtick">
    <strong><code>FILTER_FLAG_STRIP_BACKTICK</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     移除反引号字符。
    </span>
   </dd>

  
  
   <dt id="constant.filter-flag-encode-low">
    <strong><code>FILTER_FLAG_ENCODE_LOW</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     字符的 ASCII 编码值大于 32。
    </span>
   </dd>

  
  
   <dt id="constant.filter-flag-encode-high">
    <strong><code>FILTER_FLAG_ENCODE_HIGH</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     字符的 ASCII 编码值大于 127。
    </span>
   </dd>

  
  
   <dt id="constant.filter-flag-encode-amp">
    <strong><code>FILTER_FLAG_ENCODE_AMP</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     为 <code class="literal">&amp;</code> 编码。
    </span>
   </dd>

  
  
   <dt id="constant.filter-flag-no-encode-quotes">
    <strong><code>FILTER_FLAG_NO_ENCODE_QUOTES</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     不要为 <code class="literal">&#039;</code> 和 <code class="literal">&quot;</code> 编码。
    </span>
   </dd>

  
  
   <dt id="constant.filter-flag-empty-string-null">
    <strong><code>FILTER_FLAG_EMPTY_STRING_NULL</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     (目前不能使用。)
    </span>
   </dd>

  
  
   <dt id="constant.filter-flag-allow-fraction">
    <strong><code>FILTER_FLAG_ALLOW_FRACTION</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
      &quot;number_float&quot; 过滤器允许小数部分。
    </span>
   </dd>

  
  
   <dt id="constant.filter-flag-allow-thousand">
    <strong><code>FILTER_FLAG_ALLOW_THOUSAND</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     &quot;number_float&quot; 过滤器允许使用千分位分隔符（<code class="literal">,</code>）。
    </span>
   </dd>

  
  
   <dt id="constant.filter-flag-allow-scientific">
    <strong><code>FILTER_FLAG_ALLOW_SCIENTIFIC</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     &quot;number_float&quot; 过滤器允许使用科学计数法（<code class="literal">e</code>、<code class="literal">E</code>）。
    </span>
   </dd>

  
  
   <dt id="constant.filter-flag-path-required">
    <strong><code>FILTER_FLAG_PATH_REQUIRED</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     &quot;validate_url&quot; 过滤器，要求带路径部分。
    </span>
   </dd>

  
  
   <dt id="constant.filter-flag-query-required">
    <strong><code>FILTER_FLAG_QUERY_REQUIRED</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     &quot;validate_url&quot; 过滤器，要求带 Query 部分。
    </span>
   </dd>

  
  
   <dt id="constant.filter-flag-scheme-required">
    <strong><code>FILTER_FLAG_SCHEME_REQUIRED</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     要求带 scheme 的“validate_url”过滤器。
     （自 PHP 7.3.0 起弃用，且自 PHP 8.0.0 起移除，因为已经隐含在过滤器中。）
    </span>
   </dd>

  
  
   <dt id="constant.filter-flag-host-required">
    <strong><code>FILTER_FLAG_HOST_REQUIRED</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     要求带 host 的“validate_url”过滤器。
     （自 PHP 7.3.0 起弃用，且自 PHP 8.0.0 起移除，因为已经隐含在过滤器中。）
    </span>
   </dd>

  
  
   <dt id="constant.filter-flag-hostname">
    <strong><code>FILTER_FLAG_HOSTNAME</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     要求主机名使用字母数字开头，并且仅包含字母数字或连字符。（自 PHP 7.0.0 起可用）。
    </span>
   </dd>

  
  
   <dt id="constant.filter-flag-ipv4">
    <strong><code>FILTER_FLAG_IPV4</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     &quot;validate_ip&quot; 过滤器，仅仅允许 IPv4 地址。
    </span>
   </dd>

  
  
   <dt id="constant.filter-flag-ipv6">
    <strong><code>FILTER_FLAG_IPV6</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     &quot;validate_ip&quot; 过滤器，仅仅允许 IPv6 地址。
    </span>
   </dd>

  
  
   <dt id="constant.filter-flag-no-res-range">
    <strong><code>FILTER_FLAG_NO_RES_RANGE</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     &quot;validate_ip&quot; 过滤器，禁止保留 IP 地址。
    </span>
   </dd>

  
  
   <dt id="constant.filter-flag-no-priv-range">
    <strong><code>FILTER_FLAG_NO_PRIV_RANGE</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     &quot;validate_ip&quot; 过滤器，禁止私有 IP 地址。
    </span>
   </dd>

  
  
   <dt id="constant.filter-flag-email-unicode">
    <strong><code>FILTER_FLAG_EMAIL_UNICODE</code></strong>
     (<span class="type">int</span>)
   </dt>

   <dd>

    <span class="simpara">
     &quot;validate_email&quot; 过滤器，在邮件地址用户名部分允许 Unicode 字符。
     （PHP 7.1.0 起有效）
    </span>
   </dd>

  
 </dl>

</div>
</div></div></body></html>